home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 3 / Info_Mac_1994-01.iso / Development / General / HexEdit 1.0.5 / HexEditSource / HexEdit.note < prev   
Text File  |  1993-12-14  |  5KB  |  136 lines

  1. HexEdit v 1.0.5
  2.  
  3. Copyright © 1993 Jim Bumgardner
  4.  
  5. Internet Address: jbum@netcom.com
  6.  
  7.  
  8. HexEdit is a hexdump viewer and editor that works similarly to the hex editor provided with Apple's ResEdit.  It allows you to edit either the data fork or the resource fork of a file.
  9.  
  10. I wrote HexEdit because I needed to be able to insert/delete bytes from the data fork of files I was testing, and tools like FEdit don't have insert/deletion.
  11.  
  12. HexEdit is freeware.  The author retains the copyright, including the right to alter or sell the program.  You may use and copy HexEdit only on a non-commercial basis.  You may not sell this program without the author's permission.
  13.  
  14.  
  15. About this Document
  16. -------------------
  17. In order to be brief, I will avoid describing features which are similar to the ResEdit hex editor (If you aren't familiar with this tool, you probably shouldn't be using HexEdit).  I will only describe features which are unique to this program.
  18.  
  19.  
  20. System Requirements
  21. -------------------
  22. HexEdit can edit very large files (they don't need to fit into memory).  At it's current memory setting of 600k, it should be able to handle files of up to 230 megs.  If you need to edit a larger file (!), increase it's memory partition.  
  23.  
  24. Note that when HexEdit saves a file, it will (temporarily) need twice the disc space of the original file, plus a little extra for storing the changes you have made.
  25.  
  26. Opening a File
  27. --------------
  28. HexEdit supports drag and drop, automatically opening files in "Auto" mode.  You may find it useful to keep an alias to HexEdit on your desktop for this purpose.
  29.  
  30. When you use the Open command, HexEdit presents a standard file dialog with three radio buttons, labeled "Data" "Resource" and "Auto".
  31.  
  32. "Data" opens the data fork.
  33.  
  34. "Resource" opens the resource fork.
  35.  
  36. "Auto" opens the data fork, if there is any data in it, otherwise it opens the resource fork.
  37.  
  38.  
  39. Saving a File
  40. -------------
  41. When you save a file with HexEdit, it automatically backs up the last version of the file, renaming it to OriginalName~  (the original name with a tilde after it).
  42.  
  43. The Find Menu
  44. ------------
  45. Find
  46. This brings up a dialog box allowing you to search for a sequence of hex bytes, or ascii
  47. text.
  48.  
  49. Search Forward
  50. This searches for  the last search string, forward until the end of the file.
  51.  
  52. Search Backward
  53. This searches for the last search string, backward until the beginning of the file.
  54.  
  55. Goto Address
  56. This allows you to specify an address, either in hex or in decimal, and scroll to that
  57. address.
  58.  
  59. The Options Menu
  60. ----------------
  61. There are two checkmark options on the Options menu, both of which are turned off by default.
  62.  
  63. Hi Order Ascii
  64. This displays ascii values in the ascii part of the dump which are higher than 80h - you will see the accents, diacriticals and symbols that are in the monaco font that HexEdit uses.  This also makes it a little harder to pick out English text if you are searching for it in a large binary.
  65.  
  66. Decimal Addresses
  67. This causes the addresses to be displayed in decimal, rather than hex.
  68.  
  69. Overwrite
  70. This toggles between insert mode (the default) and overwrite mode.  Overwrite mode
  71. allows you to replace a sequence of bytes without affecting the offset of the subsequent
  72. bytes.
  73.  
  74. Revision History
  75. 12/14/93
  76. Version 1.0.5
  77.         Fixed editing bug that occured when you typed in some chars, then positioned
  78.     the insertion point to the beginning or the middle of those chars and deleted a char.
  79.  
  80. 12/13/93
  81. Version 1.0.4
  82.     Fixed bug that caused HexEdit to crash on SEs, Portables, and other
  83.        Black and White macs.
  84.     Fixed scrolling bug that occurred on very large files.
  85.     Improved redrawing speed on very large files.
  86.     Eliminated cursor flashing when HexEdit is in background.
  87.     Greys out menus when windows are closed.
  88.     Added Freeware message to about box.
  89.  
  90. 9/10/93
  91. Version 1.0.3
  92.         Fixed a couple nasty bugs that caused HexEdit to behave erratically on files 
  93.     that couldn't fit in memory.  The bug caused HexEdit to crash and not save
  94.     these files properly.
  95.  
  96. 8/30/93
  97.     Cmd-W Closes Find Window
  98.     Removed ellipses from New menu item
  99.     Edit+Find menus dim appropriately
  100.  
  101. 8/23/93
  102.         Changed ok button to say "Goto" instead of "Search" on goto dialog.
  103.         Changed Cmd-Key shortcuts to be more MPW compatible
  104.         Fixed some menu items to disable when windows are closed
  105.         Added Select All
  106.         Added better About Box
  107.       Fixed Cursor I-Beam problem.
  108.  
  109. 7/8/93
  110. Version 1.0.2
  111.      Changed length display to decimal when appropriate
  112.    Fixed resizing window bug
  113.    Removed "preferences" from edit menu
  114.    Made checkmark preferences permanent
  115.    Added Backup File toggle
  116.    Added support for Zoom Box.
  117.    Windows can be resized up to max size.
  118.  
  119.  
  120. 7/6/93
  121. Version 1.0.1
  122.   Removed dependence on system 7, 32-bit quickdraw.
  123.   Fixed bug with radio buttons on open file dialog.
  124.   Sped up display for selecting.
  125.  
  126.  
  127. 7/4/93
  128.   Added Overwrite toggle switch
  129.     Added Goto Address
  130.  
  131. 7/2/93
  132.     Added Ascii/Hex Search
  133.  
  134. 7/23/93
  135.     Version 1.0 Released
  136.